home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 1 / PC Actual CD 01.iso / share / dos / progr / micro_c.arj / READ.ME < prev    next >
Encoding:
Text File  |  1993-10-05  |  8.8 KB  |  167 lines
  1.                           * The DDS MICRO-C Compiler *
  2.     
  3.        DDS MICRO-C is a tiny compiler for the  'C'  language.  It  has  been
  4.     designed to be  VERY  portable,  and  can  be  moved  between  different
  5.     processors and operating systems with little difficulty.
  6.     
  7.        MICRO-C should not be compared to MICROSOFT, TURBO,  or  any  of  the
  8.     other P.C. compilers, because it it intended for en  entirely  different
  9.     purpose. These are very good compilers, but they are  large,  expensive,
  10.     and dedicated to specific computer environments. MICRO-C is tiny (it can
  11.     be made to run in less that 32K), and allows you to take it anywhere you
  12.     want.
  13.     
  14.        The complete MICRO-C package includes all  source  code  and  support
  15.     files  you  need  to  port  the  compiler  to   any   environment.   The
  16.     documentation also contains detailed information  on  writing  new  code
  17.     generators for other  processors.  We  also  have  code  generators  and
  18.     complete development packages available  for  a  number  of  processors,
  19.     including: 68HC08, 6809, 68HC11, 68HC16, 8051/52,  8080/8085/Z80,  80x86
  20.     and 8096. See the included CATALOG file for more information.
  21.     
  22.        MICRO-C is also  an  excellent  learning  tool.  Not  only  does  the
  23.     complete, well documented source code for  the  compiler  and  utilities
  24.     give you the opportunity to explore and understand those  programs,  the
  25.     source code for the library gives you information on all kinds of system
  26.     programming, such as:
  27.     
  28.                 - DOS and BIOS services
  29.                 - Video screen and windowing functions
  30.                 - Interrupt driven serial communications
  31.                 - Terminate and Stay Resident (TSR)
  32.                 - Lots MORE (Over 170 functions)
  33.     
  34.        For more information on the compiler, see the file MC.DOC. This  file
  35.     is quite large, make sure you are in no hurry before printing  it  on  a
  36.     slow printer. The table of contents pages are printed last,  and  should
  37.     be inserted between the title page and page 1.
  38.     
  39.        MICRO-C is no longer  "User  supported  Software"  (shareware).  This
  40.     archive contains a "DEMO" package, consisting of the IBM PC  executables
  41.     and support files. If you like what you see,  and  wish  to  obtain  the
  42.     complete package with  source  code  for  the  compiler,  libraries  and
  43.     utilities, Fill out the order form in the  enclosed  CATALOG  file,  and
  44.     send it along with the required payment to:
  45.     
  46.                         Dunfield Development Systems
  47.                         P.O. Box 31044
  48.                         Nepean, Ontario (Canada)
  49.                         K2B 8S8
  50.     
  51.        You will receive the complete MICRO-C package, which includes:
  52.     
  53.             - More utilities, such as MAKE, TOUCH, SLINK, SLIB, SINDEX.
  54.             - Complete source code for compiler, libraries and utilities.
  55.             - MANY more (and useful) example programs (with source), see
  56.               the summary at the end of the MC-VS-SC.DOC file.
  57.             - Additional code generators and pre-configured development
  58.               packages are available, see included CATALOG file.
  59.     
  60.                               * Getting Started *
  61.     
  62.        To install MICRO-C on a hard drive, simply  create  a  directory  and
  63.     unpack this archive into it. The directory  "\MC"  is  preferred,  since
  64.     some of the utilities assume this is the MICRO-C home  directory  unless
  65.     told otherwise.
  66.     
  67.        Once you have installed the system, refer  to  the  section  entitled
  68.     "THE COMMAND CO-ORDINATOR" in the MC.DOC file for information on how  to
  69.     compile programs using the 'CC' command. You should either  include  the
  70.     MICRO-C directory "\MC" in your PATH, or  copy  the  CC.COM  file  to  a
  71.     directory which is already in your PATH. Also, make sure that  the  MASM
  72.     and LINK commands are available on your  system.  The  MCDIR  and  MCTMP
  73.     environment variables should be set up  as  described  in  the  document
  74.     before attempting to use CC.
  75.     
  76.        Once you have everything set up, you may wish to try  compiling  some
  77.     of the example programs which are included in this archive.
  78.     
  79.                             * MICRO-C under MS-DOS *
  80.                             * Implementation notes *
  81.     
  82.        This 8086 MS-DOS implementation of the compiler produces code for the
  83.     Microsoft MASM (or compatible) assembler in either  the  TINY  or  SMALL
  84.     models. The LINK utility is required to create an EXE  file.  NOTE  that
  85.     programs produced for the TINY  model  will  execute  as  ".EXE"  files,
  86.     however, due to PSP being outside of the data/code segment, command line
  87.     parameters are only available when the program is  converted  to  ".COM"
  88.     format with the supplied EXE2BIN utility.
  89.     
  90.        The memory model to use is selected by  the  runtime  library,  which
  91.     MUST BE FIRST in the list of object files  passed  to  the  linker.  The
  92.     PC86RL_T.OBJ file distributed with MICRO-C is configured  for  the  TINY
  93.     model, and the PC86RL_S.OBJ file is configured for the SMALL model.
  94.     
  95.        The variables ARGC and ARGV (Note  capitals)  are  available  in  the
  96.     runtime  library  module  for  use  as  EXTERNAL  references  from  your
  97.     programs. This makes it easy for  a  function  other  than  'main()'  to
  98.     access the programs arguments.  The  variables  PSP  and  ENV  are  also
  99.     available to  determine  the  PROGRAM  SEGMENT  PREFIX  and  ENVIRONMENT
  100.     segments.
  101.     
  102.             ie:     extern int ARGC;        /* Count of arguments */
  103.                     extern char *ARGV[];    /* Array of ptrs to args */
  104.                     extern int PSP;         /* PSP segment */
  105.                     extern int ENV;         /* Environment segment */
  106.     
  107.        If you are using a DOS version prior to  3.0,  the  argv[0]  (program
  108.     name) argument will not work correctly.
  109.     
  110.        MICRO-C has been tested with these PC assemblers:
  111.     
  112.             MASM 3.0    - Works OK
  113.             MASM 4.0    - Works OK
  114.             MASM 5.1    - Works OK
  115.             TASM 1.0    - Works OK
  116.             TASM 2.01   - Works OK
  117.             A86 3.21    - DOES NOT WORK (not fully MASM compatible)
  118.     
  119.                            * Files in this archive *
  120.     
  121.             READ.ME         - This file
  122.             CATALOG         - Catalog of available software
  123.             MISCINFO        - Common questions and answers
  124.             MC.DOC          - MICRO-C Technical Documentation
  125.             LIBRARY.DOC     - MICRO-C Library Reference
  126.             MC-VS-SC.DOC    - Comparison of MICRO-C and SMALL-C
  127.             CINTRO.DOC      - Introduction to 'C'
  128.             CC.COM          - Command Co-ordinator
  129.             MCP.COM         - Preprocessor
  130.             MCC.COM         - PC/80x86 Compiler
  131.             MCO.COM         - PC/80x86 Optimizer
  132.             EXE2BIN.COM     - Executable to Binary convertor
  133.             WINDEMO.COM     - Window package demonstration
  134.             LC.BAT          - Batch file to link multiple objects
  135.             PC86RL_T.OBJ    - Tiny model runtime library
  136.             PC86RL_S.OBJ    - Small model runtime library
  137.             MCLIB.LIB       - MICRO-C Function Library
  138.             *.h             - Header files as described in the documentation
  139.             *.c             - Various example programs
  140.     
  141.        All of the source and header files  ('.c',  and  '.h')  were  written
  142.     using tab stops every 4 characters, which is much  more  convenient  for
  143.     'C' development than the usual MS-DOS tab stops of every  8  characters.
  144.     Source for a program called "type4.c" is provided, which  reads  a  file
  145.     and displays it using  spaces  to  simulate  the  tabs  at  4  character
  146.     intervals. To compile this program, use:
  147.     
  148.                                     cc type4
  149.     
  150.        The resulting "type4.com" file may be used to view/print  the  source
  151.     files with proper spacing.
  152.                         * Limited Distribution License *
  153.     
  154.        Permission is granted to copy and distribute this "demo" archive  via
  155.     electronic "Bulletin Board Systems" (BBS), and  disk  copying  services,
  156.     subject to the following restrictions:
  157.     
  158.     - The archive must be presented in its original form, without modification.
  159.     
  160.     - Only one version of this archive may be offered at any given time, IE: if
  161.       you post a new version of one of my shareware products, any older versions
  162.       of that product, which were previously available must be removed and no
  163.       longer offered for distribution.
  164.     
  165.     - I reserve the right to request of anyone distributing this archive that
  166.       they upgrade to the current release (which I will provide).
  167.